home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / GRAPTIES / CGHGIF.LZH / CGHGIF.DOC next >
Text File  |  1989-01-22  |  5KB  |  108 lines
  1.                CGHGIF 3.2 -- A GIF Decoder for CGA and Hercules
  2.              Copyright (C) 1988 By Chris Babcock [CIS 72657,2126]
  3.  
  4.           GIF and "Graphics Interchange Format" are trademarks (tm)
  5.                of CompuServe Incorporated, an H&R Block company
  6.  
  7.  
  8. Release date:   January 21, 1989  Version 3.2   (First)
  9.  
  10.  
  11.  
  12.      This program is a GIF decoder for IBM PC/XT/AT and compatible computers
  13. with either a CGA (Color Graphics Adaptor) or a monochrome Hercules video
  14. card.  Images are scaled and dithered to black and white pictures.  CGHGIF has
  15. gone through a two month development and testing period to assure the absence
  16. of major bugs.  If you encounter any problems, I would like to know so it can
  17. be corrected.
  18.  
  19.      CGHGIF can detect the video card being used and automatically configure
  20. itself at run-time.  I have found that the Hercules checking does not work on
  21. all boards so a command line modifier "/H" has been added to force the
  22. Hercules mode.  All the commands will work with either card.  If you are using
  23. a Hercules card and the screen blanks after a little while after the program
  24. has begun to process the GIF file, don't panic; it is normal.  The screen will
  25. return to normal when the image processing is finished.
  26.  
  27.      The calling convention for CGHGIF is described below:
  28.  
  29.   CGHGIF [-H] [-W] [-B] [-P] [-F"Path/Name (no ext)"] [-?] [Filename[.ext]]
  30.  
  31.      It is not as confusing as it first looks.  Each part enclosed in brackets
  32. is optional.  I'll start by listing the options separately.
  33.  
  34.   + "-H"  -  As noted in the above text, this option will force the program to
  35.              assume a Hercules graphics card is in use.
  36.  
  37.   + "-W"  -  CGHGIF supports multiple image GIFs.  This option refers to
  38.              keeping the program from waiting for a keypress to continue to
  39.              the next image.  It is useful with GIFs with animation or for
  40.              converting each frame to a standard format with the "-B" and "-P"
  41.              options.
  42.  
  43.   + "-B"  -  This option allows the frame on screen to be saved as a Basic
  44.              BLOAD (CGA) image.  The filename specified for the GIF is used
  45.              with the extension replaced with a "B" followed by its number in
  46.              sequence 00 to 99.  This allows multiple frames to be saved.
  47.  
  48.   + "-P"  -  The image is saved to diskette with this option also.  The
  49.              differences are in the format and the extension.  Like the above
  50.              option, the extension takes the form of a letter and a number in
  51.              sequence.  The letter naturally is "P".  The format is "PIC"
  52.              which is supported by a few GIF encoders and some paint programs.
  53.  
  54.   + "-F"  -  This is a more complex option.  It allows the resulting files
  55.              from either of the two saving options to be redirected to a new
  56.              path and filename.  The option takes the form of -F followed by
  57.              the new name or new path/name in quotation marks.  The filename
  58.              MUST NOT HAVE AN EXTENSION.
  59.  
  60.   + "-?"  -  This simply lists each option and a brief description on the
  61.              screen as a quick reference.
  62.  
  63.      A good use for the saving and "-W" options is to save all the frames in a
  64. given GIF to your preferred storage method for modification or faster viewing.
  65. Take a look at the command line below:
  66.  
  67.   CGHGIF -W -B SAMPLE
  68.  
  69.      The command will cause the GIF named "SAMPLE" to be decoded and each
  70. image in it will be written out to a file in BLOAD format.  The resulting
  71. files will be named, for example, as "SAMPLE.B00", "SAMPLE.B01", "SAMPLE.B02"
  72. and so on to the end.  If you would like the files to be named "TEST.B00" in
  73. subdirectory "PICS" on drive C:, then the following would be used:
  74.  
  75.   CGHGIF -W -B -F"C:\PICS\TEST" SAMPLE
  76.  
  77.      In addition to the command line options, there are commands that can be
  78. invoked with key presses after the image is on screen.  These commands will
  79. not be usable if the "-W" option has been selected.  They are listed and
  80. described below:
  81.  
  82.   + "Q"   -  Causes the program to exit to DOS without looking for any further
  83.              images in the GIF file.
  84.  
  85.   + "R"   -  Inverses the graphics screen.  Black becomes white, and white
  86.              becomes black.  This is useful with portable computers with a
  87.              reversed color LCD screen (ex. Toshiba 1000).
  88.  
  89.   + "B,P" -  Same as the command line options.  Saves under the appropriate
  90.              format.
  91.  
  92.   + other -  Exits the program if there are not any further images in the GIF
  93.              file, or starts decoding the next image.
  94.  
  95.      This program was originally written as a test of Floyd/Steinberg error
  96. distribution dithering using a 320 by 200 black and white screen.  It grew
  97. later to include the Burkes dither filter (developed by Dan Burke) and began
  98. using the 640 by 200 screen for better blending.  Later, the program was
  99. updated to support Hercules and changed to another dithering method which
  100. increased the speed without decreasing the quality.  I am aware that this
  101. program is slow and I am working on it.  For now, enjoy the library of GIF
  102. images with hopefully a better CGA or Hercules representation.
  103.  
  104.       I can be reached on CompuServe, number 72657,2126 either by EasyPlex or
  105. I am usually attending the GIF public conference in room 18 in the
  106. GRAPHSUPPORT forum (previously PICS).
  107.  
  108.